home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / emulator / bsvc-1.000 / bsvc-1 / bsvc-1.0.4 / README < prev   
Text File  |  1995-07-26  |  2KB  |  91 lines

  1.  
  2. BSVC "A Microprocessor Simulation Framework"
  3. ============================================
  4.  
  5. I've tested BSVC under the following operating systems (the makefiles
  6. for these systems should work):
  7.  
  8.     Linux  1.x.x
  9.     Ultrix 4.3
  10.     HP-UX  9.0
  11.     SunOS
  12.     Solaris
  13.  
  14. I'm sure there are bugs in the program, so if you find them let me know.
  15.  
  16.  
  17. BSVC Requirements
  18. -----------------
  19.  
  20. You will need:
  21.  
  22.    - Tcl/Tk (with the 'addinput' extension) See comp.lang.tcl for info on Tcl
  23.      or get the new Tcl and the Tk Toolkit book by John K. Ousterhout.
  24.      (Most prebuilt versions of Tcl/Tk on Linux have this extension installed).
  25.  
  26.    - GNU gcc and libg++
  27.  
  28.  
  29. Installation
  30. ------------
  31. 1) Edit the Makefile.common in the bsvc/src directory
  32.  
  33.      - Change PROJECT_BASE to where you have untarred the BSVC
  34.        package
  35.  
  36.      - Change INSTALL_DIR to where you want the BSVC executables
  37.        installed. (I usually install them in bsvc/bin)
  38.  
  39.      - Change WISH to the path/filename of the Tcl/Tk "wish"
  40.        executable
  41.  
  42.      - Change the WWW_BROWSER 
  43.  
  44. 2) Build the BSVC executables:
  45.  
  46.      - Choose the correct Makefile.your_os for your system and execute:
  47.  
  48.          make -f Makefile.your_os     (e.g for Linux use Makefile.linux)
  49.  
  50.      - If there is no Makefile.your_os then you'll have to make one
  51.        yourself (sorry!).
  52.  
  53. 3) Install the BSVC executable:
  54.  
  55.      - To install the BSVC executables do:
  56.  
  57.          make -f Makefile.your_os install
  58.  
  59.  
  60. After you've built the programs there are some sample setups and programs for 
  61. the Motorola 68000 simulator in the bsvc/samples/Motorola68000 directory.
  62.  
  63. Just cd to the bsvc/bin directory and type 'bsvc' to start the user interface.
  64. Then choose "Load setup" and select the TutorTelnet.setup in the 
  65. bsvc/samples/Motorola68000 directory.  After the system starts up choose 
  66. "Load program" and load in the tutor.h68 program.  Select "Reset" and press 
  67. "Run" in about 10 seconds you should see "TUTOR >" in the xterm that pops up.
  68.  
  69. I would suggest adding the bsvc/bin directory to your PATH if you're going
  70. to be using it very often.
  71.  
  72. There's a postscript version of the User Manual in the bsvc/doc/manual
  73. directory.
  74.  
  75. If you have any questions or comments send me mail at:
  76.  
  77.   bwmott@eos.ncsu.edu
  78.  
  79. If you have questions about the Hector 1600 microprocessor you can contact
  80. Dr. Tom Miller at:  
  81.  
  82.   tkm@eos.ncsu.edu
  83.  
  84.  
  85. LICENSE
  86. -------
  87.  
  88.    See the License file for information.  
  89.  
  90.  
  91.